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INTRODUCTION 



This document is intended to serve as a quick reference 
and convenient memory aid for the user with some familiarity 
with Multics command conventions. 

This guide presents an abbreviated description of the 
Multics commands and active functions described in detail in 
the Multics Programmers' Manual Commands and Active 
Functions (MPM Commands), Order No. AG92. The com- 
mands are presented in alphabetical order, with each descrip- 
tion showing the proper usage and a list of the control 
arguments and optional arguments that may be used. Control 
arguments are only listed; they are not defined in detail in 
this document. 

The reader is expected to be familiar with the Multics 
command environment conventions. The following terms are 
defined here and are not explained at each occurrence in this 
document. If the reader needs more information on termi- 
nology than is given here, he should refer to "Glossary of 
Multics Terms" in Section I of the Multics Programmer's 
Manual Reference Guide, Order No. AG91. 

ACL access control list; it describes who may access 

an entry in the Multics storage system and in 

what way (see modes below), 
modes access identifiers; used to define the kind of 

access a user has to a storage system entry. The 

modes are: 

segments directories 
r (read) s (status) 

e (execute) m (modify) 

w (write) a (append) 

Null access can also be specified for either seg- 
ments or directories: " ", n, or null, 
path pathname of an entry; it can be relative or 

absolute. 

Person_id user's registered personal identifier; usually 
some form of the user's surname; unique at 
site. 
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Projected user's registered project identifier; a project is 
an arbitrary set of users grouped together for 
accounting and access control purposes. 

User_id access control name of the form Person_id. 

Project_id.tag; since the tag portion is rarely 
explicitly given, the term User_id is often de- 
fined as a Person_id.Project_id pair. 
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COMMANDS 



The format of each command description in this docu- 
ment is based on those found in the MPM Commands. The 
command name, in boldface type, is shown first, followed by 
the usage line. In the usage line, the following conventions 
apply: 

1. If a command accepts more than one of a specific 
argument, an "s" is added to the argument name 
(e.g., paths, control_args). 

2. To indicate one of a group of similar arguments, an 
"i" is added to the argument name (e.g., pathi, 
control_argi). 

3. Multiple arguments that must be given in pairs are 
indicated by xxxl yyyl . . . xxxnyyyn. 

4. Pathnames that must be given in pairs are indicated by 
pathlj, path21 . . . pathlnpath2n. 

5. Optional arguments are enclosed in braces (e.g., 
{path}, {-control_args}). All other arguments are 
required. 

To illustrate these conventions, consider the following 
usage line: 

command {paths} {-control_args} 

The lines below are just a few examples of valid invocations 
of this command: 

command 
command path 

command path path -control_arg 
command path -control_arg — control_arg 
command -control_arg 
command -control_arg -control_arg 

For simplicity, when an argument takes a value other 
than a pathname (indicated by "path"), the value is indicated 
as follows: 

XX character string 

N number, decimal or octal 

DT date-time character string in a form acceptable 

to the convert_date_to_binary_ subroutine 
described in the Multics Programmers' Manual 
Subroutines, Order No. AG93. 
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If more information is needed about a particular value, 
the reader should consult the appropriate command descrip- 
tion in the MPM Commands. 

The commands listed below are grouped according to 
their function. An abbreviated description for each com- 
mand is given in the following pages, arranged in alphabetical 
rather than function order. 
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Access to the System 
(preaccess requests) 

MAP 

963 

029 
dial 
enter 
enterp 
login 
logout 

Creating and Editing Segments 
adjust_bit_count 
basic_system 
compare_ascii 
edm 
indent 

program_interrupt 
qedx 
runoff 
runoff_abs 
set_bit_count 
sort_seg 

Segment Manipulation 
adjust_.bit_count 
archive 
compare 
compare_ascii 
copy 
crea te 
delete 

delete_ force 
link 
move 

set_bit_count 
sort_seg 
truncate 
unlink 
vfile_adjust 



Directory Manipulation 
add _ name 
create_dir 
delete_dir 
delete_name 
fs_chname 
link 
list 

rename 

safety_sw_off 

safety_sw_on 

status 

unlink 

vfile_status 

Access Control 
delete_acl 
delete_iacl_dir 
delete_iacl_seg 
list_acl 
list_iacl_dir 
list_iacl_seg 
set_acl 
set_iacl_dir 
set_iacl_seg 

Address Space Control 
add_search_rules 
change_default_wdir 
change_wdir 
dele te_ sear ch_ rules 
initiate 

list_ref_names 

new_proc 

print_default_wdir 

print_proc_auth 

print_search_rules 

print_wdir 

set_search_rules 

terminate 

terminate_ ref name 
terminate_ segno 
terminate_single_ ref name 
where 
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Formatted Output Facilities 
cancel_daemon_ request 
dprint 
dpunch 

dump_segment 

list_daemon_ requests 

print 

runoff 

runoff_abs 

Language Translators, 
Compilers, Assemblers, 
and Interpreters 

apl 

basic 

basic_ system 
bind 

cancel_ cobol_ program 
cobol 

display _ cobol_ run_ unit 

format_ cobol_source 

fortran 

fortran_abs 

indent 

pll 

pll_abs 

profile 

qedx 

run_ cobol 
runoff 
runoff_abs 
set_cc 

stop_cobol_run 

Object Segment 
Manipulation 

archive 

bind 



Debugging and Perform- 
ance Monitoring Facilities 
change_error_ mode 
cumulative_page_ trace 
debug 

display _pllio_ error 

dump_ segment 

page_trace 

probe 

profile 

progress 

ready 

ready_off 

ready_on 

reprint_error 

trace 

trace_ stack 

Input/Output System Control 
assign_ resource 
cancel_ daemo n_ req uest 
close_file 
console_output 
copy_cards 
display _ pi 1 io _ err or 
dprint 
dpunch 
file_ output 
io_call 
line_length 
list_daemon_requests 
list_resources 
print 

print_attach_ table 

print_request_types 

set_cc 

set_tty 

unassign_resource 

vfile_adjust 

vfile_status 
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Command Level Envirom 
abbrev 

add_search_rules 

answer 

basic_system 

change_default_wdir 

change_error_mode 

change_wdir 

console_output 

delete_search_rules 

do 

exec_com 

file_ output 

get_com_line 

line _ length 

memo 

new_proc 

print_default_wdir 

print_search_rules 

print_wdir 

program_ interrup t 

ready 

ready _ off 

ready _ on 

release 

reprint_error 
set_com_line 
set_search_rules 
start 

Communication Among 
Users 

accept_ messages 

defer_ messages 

immediate_ messages 

mail 

print_auth_names 
print_ messages 
send_ message 
who 



Communication with the 
System 

check_info_segs 
help 

how_ many _ users 

print_motd 

who 

Accounting 
get_ quota 
move_quota 
resource_ usage 

Control of Absentee 

Computations 

cancel_abs_request 

enter_abs_request 

fortran_abs 

how_many_users 

list_abs_requests 

pll_abs 

runoff_abs 

who 

GCOS Environment 

gcos 

gcos_ card _ utility 
gcos_sy sprint 
gcos_syspunch 

Miscellaneous Tools 
calc 
decode 
encode 
memo 
progress 
walk_ subtree 
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abbrev, ab 

provides the user with a mechanism for abbreviating 
parts of (or whole) command lines in the normal com- 
mand environment. 

Usage: abbrev 

CONTROL REQUESTS 

,a <abbr> <rest of line> 

add the abbreviation <abbr> to the current profile 
segment. 

.ab <abbr> <rest of line> 

add an abbreviation that is expanded only if found 
at the beginning of a line or directly following a 
semicolon (;) in the expanded line. 

.af <abbr> <rest of line> 

add an abbreviation to the profile segment and 
force it to overwrite any previous abbreviation with 
the same name. 

.abf <abbr> <restofline> 

add an abbreviation that is expanded only at the 
beginning of a line and force it to replace any pre- 
vious abbreviation with the same name. 

.d <abbrl> . . . <abbrn> 

delete the specified abbreviations from the current 
profile. 

.f 

enter a mode (the default mode) that forgets each 

command line after executing it. 
.1 <abbrl> . . . <abbrn> 

list the specified abbreviations with the things they 

stand for. 
.la <ietteri> . . . <lettern> 

list all abbreviations starting with the specified 

letters. 

•q 

quit using the abbrev processor. 

.r 

enter a mode that remembers the last line expanded 
by abbrev. 
.s <rest of line> 

show the user how <rest of line> would be ex- 
panded but do not execute it. 
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,u <profile> 

specify to abbrev the pathname of a profile seg- 
ment to use. 

•P 

print the name of the profile segment being used. 

.<space> <rest of line> 

pass <rest of line> on to the current command 
processor without expanding it. 

BREAK CHARACTERS 

Break characters (any combinations) must be used to 
delimit abbreviations in a command line. 

tab semicolon ; 

newline vertical bar I 

space parentheses ( ) 

quote " less than < 

dollar sign $ greater than > 

apostrophe ' brackets [ ] 

grave accent x braces { } 
period 

accept_messages, am 

initializes or reinitializes the user's process for accept- 
ing messages sent by the send_ message command. 

Usage: am {-control_args} 

-brief, -bf 
-long 
-print 
-short 

add_name, an 

adds an alternate name to the existing name(s) of an 
entry. 

Usage: an path names 
names 

additional names to be added to the entry. 

add_search rules, asr 

allows the user to change his search rules dynamically. 

Usage: asr path 11 { -control_arg path21 } . . 
. pathln { -control_arg path2n} 

pathli 

pathname of a directory to the current search 
rules (certain keywords may also be used). 
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control_arg 
-before 
-after 

path2i 

pathname representing current search rule 
(certain keywords may also be used). 

adjust_bit_count, abc 

sets the bit count of segments that for some reason do 
not have the bit count set properly. 

Usage: adjust_bit_ count paths {-control_args} 

-character, — ch 
-long, -lg 

answer 

provides a preset answer to a question asked by 
another command. 

Usage: answer ans {-control_args} command_line 

ans 

desired answer to any question. 

command_line 

any Multics command line. 

control_args 
-brief, -bf 
-times N 

apl 

invokes the Multics APL interpreter. 
Usage: apl 

archive, ac 

combines an arbitrary number of separate segments 
into one single segment. 

Usage: archive key path components 

components 

components of the archive segment. 

key 

listed below by function. 

Table of Contents Operations: 

t print the entire table of contents if no 

components are named by the path 

arguments. 



10 



tl print the table of contents in long form. 

tb print the table of contents, briefly. 

tlb print the table of contents in long form, 

briefly. 
Append Operations: 

a append named components to the ar- 
chive segment, 
ad append and delete, 
adf append and deleteforce. 
ca copy and append, 
cad copy, append, and delete, 
cadf copy, append, and deleteforce. 

Replace Operations: 

r replace components in, or add com- 
ponents to the archive segment, 
rd replace and delete, 
rdf replace and deleteforce. 
cr copy and replace, 
crd copy, replace, and delete, 
crdf copy, replace, and deleteforce. 

Update Operations: 

u update. 

ud update and delete. 

udf update and deleteforce. 

cu copy and update. 

cud copy, update, and delete. 

cudf copy, update, and deleteforce. 

Delete Operations: 

d delete from the archive those components 

named by the path arguments, 
cd copy and delete. 

Extract Operations: 

x extract from the archive those com- 
ponents named by the path arguments, 
placing them in segments in the storage 
system. 

xf extract and deleteforce. 

assign_resource, ar 

calls the resource control package (RCP) to assign a 
resource to the caller's process. 

Usage: assign_resource type {-control_args} 
type 

tape punch 
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disk reader 
console special 
printer 

control_args 

—comment XX, - com XX 
-density N, -den N 
-device XX, -dv XX 
-line_length N, -11 N 
-long, -lg 
-model N 
-system, -sys 
-track N, -tk N 
-train N, -tn N 
-volume XX, -vol XX 

basic 

invokes the BASIC compiler. 

Usage: basic path {-control_arg} 

-compile 
-time N 

basic_system, bs 

standard BASIC source editor and run dispatcher. 

Usage: basic_ system {path} 

REQUESTS 

delete all 
or 

delete first {last} 

deletes the specified lines. 

exec command_line 

passes the command_line argument to the Multics 
command processor. 

get {path} 

clears the internal buffers so that the user can work 
on a different program. 

line_ number 

deletes that source line if such a line number exists. 

line_number source_line 

adds or replaces a BASIC source line (source_line) 
in proper sequence. 

list 

prints the entire current internal segment. 
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quit 

exits from basic_ system and returns to command 
level. 

rseq {first} {increment} 

resequences the line numbers so that they differ by 
a fixed increment. 

run 

calls the BASIC compiler to run the current 
internal source segment. 

save { path } 

stores the current internal source segment in the 
segment whose pathname is specified by path. 

time N 

establishes a time limit of N CPU seconds on the 
execution of the program. 



bind, bd 

produces a single bound object segment from one or 
more unbound object segments. 

Usage: bind paths {-control_arg} 

-list, -Is 
-map 

-update paths, -ud paths 



calc 

provides the user with a calculator. 
Usage: calc 

REQUESTS 

< expression > type value of 

expression. 

< variable > = < expression > assign value of ex- 

pression to variable, 
list list variables, 

q return to command 

level 

EXPRESSIONS 

order of evaluation 

1. expression within parentheses 

2. function references 
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3. prefix +, prefix - 

4. ** 

5. *,/ 

6. + ,- 

FUNCTIONS. 

sin, cos, tan, atan, abs, In, log 

cancel_abs_request, car 

allows a user to delete a request for an absentee 
computation. 

Usage: cancel_abs_request path { -control_args} 

-all, -a 
-brief, -bf 
-queue N, — q N 

cancel_cobol_program, ccp 

cancels one or more programs in the current COBOL 
run unit. 

Usage: cancel_coboI_ program names {-control_arg} 

control_arg 

-retain_data, -retd 

names 

name specified in the PROG-ID statement. 

cancel_daemon_request, cdr 

cancels a dprint or dpunch request. 

Usage: cancel_daemon_request path {-control_args} 

-all, -a 
-brief, -bf 
-queue N, -q N 
-request_type XX, -rqt XX 

change_default_wdir, cdwd 

sets a specified directory as the user's default working 
directory for the duration of the current process or 
until the next change_default_wdir command is 
issued. 

Usage: change_default_wdir {path} 
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change_error_mode, cem 

controls the amount of information printed by the de- 
fault handler for system conditions. 

Usage: change_error_mode {-control_args} 

-brief, -bf 
-long, -lg 



change_wdir 

changes the user's working directory to the directory 
specified as an argument. 

Usage: change_wdir {path} 



check_info_segs, cis 

prints a list of new or modified segments. 

Usage: check_info_segs {-control_args} 

-brief, -bf ' 
-call command_line 
-date DT, -dt DT 
-long, -lg 
-no_update, -nud 

-pathname star_name_path, -pn star_name_path 

ciose_fiie, cf 

closes specified FORTRAN and PL/I files. 

Usage: close_file {-control_arg} filenames 

control_arg 
-all 

filenames 

names of the open files. 



cobol 

invokes the COBOL compiler. 
Usage: cobol path { -control_args} 



-brief, -bf 
-check, -ck 
-debug, -db 
-format, -fmt 
-list, -Is 
-map 



-severityN, -svN 
-source, -sc 
-symbols, -sb 
-table, -tb 
-time, -tm 
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compare 

compares two segments and lists their differences. 

Usage: compare pathl { loffset 1 } path2 { |offset2 } 
{-control_args} 

pathl, path2 

pathnames of segments to be compared. 

offsetl, offset2 

octal offsets within the segments to be compared. 

control_args 

-length N, -In N 
-mask N 

compare _ascii, cpa 

compares two ASCII segments and prints the changes 
made to the segment specified by pathl to yield the 
segment path2. 

Usage: compare_ascii pathl path2 {minchars} 
{ minlines} 

path 1 , path2 

pathnames of segments to be compared. 

minchars 

decimal number specifying the minimum num- 
ber of characters that must be identical before 
the segments are again assumed to be "in sync" 
after a difference in the two segments. 

minlines 

decimal number specifying the minimum num- 
ber of lines that must be identical. 

console_output, co 

directs the user_output to the terminal (See 
file_output.) 

Usage: console_ output 
copy, cp 

creates copies of specified segments and/ or multiseg- 
ment files in the specified directories with the speci- 
fied names. 

Usage: copy pathl 1 { path2I } . . . pathln { path2n} 
{ -control_args} 
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pathli 

pathname of segment to be copied. 
path2i 

pathname of a copy to be created from pathli. 

control_args 
-acl 
-all, -a 
-brief, -bf 
-name, — nm 

copy_cards 

copies specified card image segments from system 
pool storage into a user's directory. 

Usage: copy_cards deck_name {path} 

deck_name 

name entered on deck_id card. 

create, cr 

creates a storage system segment in a specified direc- 
tory (or in the working directory). 

Usage: create paths 

create_dir, cd 

creates a specified storage system directory branch in a 
specified directory (or in the working directory). 

Usage: create_ dir paths { - control_ args } 

-access_class XX, -acc XX 
-quota N 

cumulative_page_trace, cpt 

accumulates page trace data so that the total set of 
pages used during the invocation of a command or sub- 
system can be determined. 

Usage: cumulative_page_ trace command_line 
{ -control_args} 

command_line 

character string to be interpreted as a command 
line. 

control_args 

-count, -ct -reset, -rs 
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-flush 

-interrupt N, -int N 
-long, -jg 
-loop N 
-print, -pr 



-short, -sh 
-sleep N 
-timers 
-total, -tt 
- trace path 



debug, db 

interactive debugging aid to be used in the Multics 
environment. 

Usage: debug 
DATA REQUESTS 

Format of Data Request 

< generalized address > < operator > < operands > 
Generalized Address 

[/segment name/] [offset] [segment ID] 
[relative offset] 



/segname/ 
pathname 
ref name 
seg number 
&n seg name 
seg Sentry 

rel offset 

number 

register 

Operators 

> print 
- assign 

< set break 

> transfer 
:= call 



offset 

number 

symbol 



segment ID 



&t 

&s 

&1 

&an 

&pn 

&i~ 



text 
stack 
linkage 
source line 
parameter 
internal static 



Operands 
operands 
input list 
function 
list 



Output Modes 
octal 

half -carriage octal 
decimal 
ASCII 
instruction 
pointer 

source statement 
code for line 
number 
no output 
floating point 
floating point 
bit string 
graphic 



o 
h 
d 
a 
i 

P 
s 
1 

n 
e 
f 
b 
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CONTROL REQUESTS 



Multics command 
.ai,m print argument i in mode m 

(modes: o, p, d, a, b, 1, e, f, ?) 
.be al j= A =}a2 make conditional all breaks of de- 
fault object segment 
.bcial{= ^=}a2 make conditional break i 
.bd name/no. set (or print) default object segment 
.be <line> execution line for all breaks of the 

default object segment 
.bei <line> execution line for break i 
.bge <line> execution line for all breaks 
.bgl list all breaks 

.bgn enable all breaks 

.bgo disable all breaks 

.bgr reset all breaks 

.bgt <line> establish a temporary global command 
.bl list the breaks of the default object 

segment 
.bli list break i 

.bn enable the breaks of the default 

object segment 
.bni enable break i 

.bo disable the break of the default 

object segment 
.boi disable break i 

.bp print names of all segments with 

breaks 

.br reset the breaks of the default object 

segment 
.bri reset break i 

.bsi n set skips of break i to n 

.C use crawlout registers 

.c,i continue after break fault (ignore 

next i break fault) 
.cr,i continue, in normal mode 

.ct,i continue, in temporary break mode 

.d or .D print default values 

.f use registers from last fault 

.1 set stack to ith frame 

.+i or .— i pop or push stack by i frames 

.mb change to brief output mode 

.ml change to long output mode 

.q return from debug to caller 

.ti,n trace stack from frame i for n frames 
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decode 

reconstructs an original segment from an enciphered 
segment according to a key that need not be stored in 
the system. (See encode.) 

Usage: decode pathl {path2} 

pathl 

pathname of enciphered segment. 
path2 

pathname of deciphered segment to be 
produced. 

defer_ messages, dm 

suspends printing of messages sent by the 
send_message command on the user's terminal. 

Usage: defer_messages 
delete, dl 

deletes the specified segments and/ or multisegment 
files. 

Usage: delete paths 

delete_acl, da 

removes entries from the ACLs of segments, multi- 
segment files, and directories. 

Usage: delete_acl {path} {User_ids} {-control_args} 

-all, -a 
-brief, -bf 
-directory, -dr 
-segment, -sm 

delete_dir, dd 

deletes the specified directories (and any segments, 
links, and multisegment files they contain). 

Usage: delete_dir paths 

delete_force, df 

deletes the specified segments or multisegment files, 
regardless of whether or not the safety switch is on. 

Usage: delete_force paths 
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delete_iacl_dir, did 

deletes entries from a directory initial ACL in a speci- 
fied directory. 

Usage: delete_iacl_dir {path} {llser_ids} 
{-control_args} 

-brief, -bf 
-ring N, -rg N 

delete_iacl_seg, dis 

deletes entries from a segment initial ACL in a speci- 
fied directory. 

Usage: delete_iacl_seg { path } { User_ids } 
{-control_args} 

-brief, -bf 
-ring N, -rg N 

delete_name, dn 

deletes specified names from entries that have 
multiple names. 

Usage: delete_name paths 

delete_search_rules, dsr 

allows the user to delete current search rules. 

Usage: delete_search_ruies paths 
dial, d 

connects an additional terminal to an existing process. 
Usage: dial dial_id Person_id.Project_id 
dial_id 

keyword that uniquely specifies a logged-in 
process that is accepting dial connections. 

Person_id.Project_id 

the Person_id and Project_id of the process 
the user wishes to connect to. 

display _cobol_run_unit, dcr 

displays the current state of a COBOL run unit. 
Usage: display_cobol_run_unit {-control_args} 

-all, -a 
-files 
-long, -lg 
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display_pllio_error, dpe 

describes the most recent tile on which a PL/I I/O 
error was raised and displays diagnostic information 
associated with that type of error. 

Usage: display_pllio_error 



do 

expands a command line according to the arguments 
supplied following the command string. 

Usage: do "command string" {-control args} 

command_ string 

a command line in quotes. 

control_args 

a character string argument to replace a param- 
eter designated by &i in command_string. 

modes 

-absentee 
-brief, -bf 
-go 

-interactive 
-long, -lg 
-nogo 



dprint, dp 

queues specified segments and/or multisegment files 
for printing on the line printer. 

Usage: dprint {-control_args} {paths} 



-access_label, -albl 
-bo ttom_ label XX, 
-blbl XX 
-brief, -bf 
-copy N, -cp N 
-delete, -dl 

-destination XX, -ds XX 
-header XX, -he XX 
-indent N, -in N 
-label XX, -lbl XX 
-line_length N, -11 N 



no_endpage, -nep 
-no_ label, -nlbl 
-page_length N, 

-plN 
-queue N, -q N 
-request_type XX, 

-rqt XX 
-single, -sg 
-top_label XX, 

-tlbl XX 
-truncate, -tc 
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dpunch, dpn 

queues specified segments and/or multisegment files 
for punching by the card punch. 

Usage: dpunch {-control_args} {paths} 

-brief, -bf -queue N, -q N 

-copy N, -cp N -raw 

-delete, -dl -request_type XX, 

-destination XX, -ds XX -rqt XX 

-header XX, -he XX -7punch, -7p 
— mcc 

dump_segment, ds 

prints, in octal format, selected portions of a segment. 

Usage: dump_segment path { first } { num } 
{-control_arg} 

first 

the octal number of the first word to be 
dumped. 

num 

the octal number of words to be dumped. 

control_args 

-address, -addr -name, -nm 
-bed -no_address, -nad 

-block N -no_ header, -nhe 

-character, -ch -no_offset, -nofs 
-header, -he -offset N, -ofs N 

-long, -lg -short, -sh 

edm 

invokes a simple Multics context editor. 
Usage: edm {path} 
REQUESTS 

enter input mode; exit when a line 
with only "." is typed. 

— N back up N lines. 

enter "comment" mode; exit when a 
line with only "." is typed, 
print current line number. 

b go to bottom of file, enter input 

mode. 

c N /sl/s2/ change all occurrences of string "si" 
to "s2" for N lines. 
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d N deletes N lines, 

updelete delete all lines above current line. 

E line execute "line" as a Multics com- 

mand line. 

f string find a line beginning with "string", 

i line insert "line" after current line, 

merge path insert segment "path" after current 
line. 

move M N beginning with line M, remove N 

lines and insert them after the current 
line. 

k enter brief mode (no response after f, 

n, 1, c, and s requests). 
1 string locate a line containing "string", 

n N move down N lines, 

p N print N lines, 

q exit from edm, 

qf exit directly from edm with no 

question. 

r line replace current line with "line". 

sN/sl/s2/ same as "c". 
t go to top of file, 

v enter verbose mode (opposite of k 

request). 

w path write edited copy of file into "path", 

upwrite path write all lines above current line into 
"path". 



encode 

enciphers a segment's contents according to a key that 
need not be stored in the system. (See decode.) 

Usage: encode pathl {path2} 

pathl 

pathname of segment to be enciphered, 
pathl 

pathname of the enciphered segment to be 
produced. 

enter, e 
enterp, ep 

used by anonymous users to gain access to Multics. 

Usage: enter {anonymous_name} Project_id 
{-control_args} 
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anonymous_name 

treated like person identifier. 

Project_id 

identification of the user's project. 

control_args 
-brief, -bf 
-force 

-home_dir path, -hd path 
-no_preempt, -np 
-no_print_off, -npf 
— no _ start-up, -ns 
-print_off, -pf 

-process_ overseer path, -po path 

enter_abs_request, ear 

requests that an absentee process be created. 

Usage: enter_abs_request path {-control_args} 

-arguments XX, -ag XX 
-brief, -bf 
-limit N, li N 

— output_file path, - of path 
-queue N, 
—restart, -rt 
-time DT, -tm DT 

exec_com, ec 

executes a series of command lines contained in a 
segment. 

Usage: exec_com path { optional_args} 

optional_args 

character strings substituted for &i in the 
exec_.com segment. 

Each &i (where i is an integer) in the exec_.com 
segment is replaced by the corresponding argu- 
ment to the exec_.com command; &ec_name is 
replaced by the entryname portion of the 
exec_com pathname without the ec suffix; &0 
is replaced by the path argument to the 
exec_.com command. 

CONTROL STATEMENTS 

&label location identifies location. 

&goto location transfers control to &label 

specified. 
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&attach attaches user_input to 

exec_.com segment. 

&detach detaches user_input. 

&input_line on writes input lines on 

user_output. 

&input_line off does not write out input lines. 

&command_line on writes command lines on 

user_output prior to 

execution. 

&command_line off does not write out command 
lines. 

&ready_on invokes ready message after 

execution of each command 
line. 

&ready_off turns off ready message; 

default. 

&print char_string prints char_string on 
user_output. 

&quit returns exec_.com to caller. 

&if [ACTIVE_FUNCTION -argl . . . -argn -) 
executes & then clause if 
ACT1VE_FUNCTI0N returns 
"true"; executes &else clause 
if ACTIVE_FUNCTI0N re- 
turns "false"; otherwise error. 
Each argi can also be an active 
function. 

&then THEN_CLAUSE 

can include a command line, 
input line, null statement, and 
most control statements. 
&else ELSE_CLAUSE can include a command line, 
input line, null statement, and 
most control statements. 

file_output, fo 

directs the user_output to a segment. (See 
console_output.) 

Usage: file_output {path} 

format_cobol_source, fcs 

converts pseudo free-form COBOL source programs to 
the standard fixed-format COBOL source programs. 

Usage: format_cobol_source pathl path2 
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pathl 

pathname of input segment containing pseudo 
free-form COBOL source code. 

path2 

pathname of output segment containing con- 
verted fixed-format COBOL source. 

fortran, ft 

invokes the FORTRAN compiler. 

Usage: fortran path {-control_args} 

-brief, -bf -optimize, -ot 

-brief _ table, -profile, -pf 

_bftb -severityN, -svN 

-card -source, -sc 

-check, -ck -subscriptrange, -subrg 

-convert -symbols, -sb 

- debug , - db - table , - tb 

-list, -Is -time, -tm 
—map 

fortran_abs, fa 

submits an absentee request to perform FORTRAN 
compilations. 

Usage: fortran_abs paths {-ft_args} {-dp_args} 
{-abs_ control_args } 

ft_args 

control arguments accepted by the fortran 
command. 

dp_args 

control arguments (except -delete) accepted 
by the dprint command. 

abs_control_args 
-queue N, -q N 
-hold 

-output_file path, -of path 

fs_chname 

manipulates strangely named segments because none of 
the special command system symbols (e.g., *, >) are 
interpreted. When oldname and newname are not null 
strings, fs_chname is equivalent to using the rename 
command; null string for oldname is equivalent to 
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using the add _ name command; null string for a 
newname is equivalent to using the delete_name 
command. 

Usage: fs_chname dir_name entryname oldname 
newname 

dir_name 

directory name portion of the segment. 

entryname 

entryname portion of the segment. 

oldname 

old entryname to be deleted. 

newname 

new entryname to be added. 



gcos, gc 

invokes the GCOS environment simulator to run a 
single GCOS job, immediately, in the user's process. 

Usage: gcos job_deck_path {-control_args} 

job _deck_ path 

pathname of segment containing a GCOS job 
deck. 

control_args 

listed below by function. 

Input Specifications: 

-ascii, -aci -no_canonicalize, -nocan, -no 
-gcos, -gc -truncate, -tc 

Output Specifications: 

-dprint, —dp —hold, — hd 

-dprint options "options", -list, -Is 

-dpo "options" -lower_case, -lc 

-dpunch, -dpn -raw 
-dpunch_options "options", 

-dpno "options" 

Creation of Files: 

-brief, -bf -no_bar, -nobar, -nb 

-continue, -ctu -syot_dir path, -sd path 

-debug, -db -temp_dir path, -td path 

-job_id id, -id id -userlib 
-long, -lg 
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gcos_card_utility, gcu 

copies GCOS card image files, altering their format, 
content, and medium, as specified by the user. 

Usage: gcu input_ specification output_specification 

input_ specification, output^ specification 

pathnames (or tape numbers) and control argu- 
ments. Control arguments are listed below by 
function. 

Input and Output Specifications: 
—input, —in 
-output, —out 

File Formats: 

-ascii, -aci 
-comdk, -cdk 
-gcos_ascii, -gca 
-gcos, -gc 

File Contents: 

-imcv XX 

-library XX, -lib XX 

Tape Files: 

-attached, -att 
-detach, -det 
-label XX, -lbl XX 
-tape N 

Partial Copying: 

-count N, -ct N 
-first N, -ft N 
-last N, -It N 

Output File Duplication: 
-append, -app 

Input and Output Lists: 

-all -list XX, -Is XX 

-file_input path, -fi path, -name, -nm 
-file path 

Terminal Output: 
-brief, -bf 
-debug, -db 
-long, -lg 



— no_canonicalize, -no 

-raw 

-tabsN 

-truncate, -tc 



-tape7 N 
-tape9 N 
-retain, -ret 
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gcos_sysprint, gsp 

converts a print file (either SYSOUT or simulated 
printer) produced by the GCOS environment simu- 
lator, from BCD to ASCII. 

Usage: gcos_sysprint input_path { output_path } 
{-control_args} 

input_path 

pathname of a print file produced by the 
simulator. 

output_path 

pathname into which the ASCII output lines 
are written. 

control_args 

-lower_case, -lc 
-temp_dir path, -td path 

gcos_syspunch, gspn 

converts a GCOS standard system format file, contain- 
ing BCD and binary card images, to a format suitable 
for punching using the Multics dpunch command with 
the -raw argument. 

Usage: gcos_syspunch path 

get_com_line, gel 

prints on the user's terminal the maximum length 
allowed for an expanded command line. 

Usage: get_com_line 

get_quota, gq 

returns information about the secondary storage 
quota and pages used for a specified directory. 

Usage: get_ quota paths {-control_arg} 

-long, -lg 

help 

assists users in obtaining online information about 
such things as commands, subsystems, system status, 
or changes. 

Usage: help {name} {-control_args} 
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name 

the name of an info segment which refers to a 
command or general topic. 

control_args 
-header, - he 

-pathname path, -pn path 
-search XX, -sh XX 
-section XX, -sc XX 
-title 

REQUESTS 

Each Mo segment is divided into paragraphs delimited 
by double blank lines. After each paragraph, help asks 
More help?" The user may reply: 



yes Print next block 

no print no more from this 

segment 

T f St rest of this segment 

p skip next block and 

proceed 

title Print remaining section 

titles, no questions 
qmt , exit from help 



r ~\ r tAlt nom neip 

search { XX }, sh { XX } search forward for string 
XX 

section { XX }, sc { XX } find section named XX 

how_many_ users, hmu 

prints how many users are currently logged in. 
Usage: how_many_users {args} {- control, args} 
control_args 
-absentee, -as 
-brief, -bf 
-long, -lg 

args 

Person_id 

-Projectid 

Person_id.Project_id 

immediate_messages, im 

restores the immediate printing of messages sent by 
tne send_message command. 
Usage: immediate_ messages 
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indent, ind 

improves the readability of a PL/I source segment by 
indenting it according to a set of standard conventions. 

Usage: indent oldpath {newpath} {-control_args} 

oldpath 

pathname of input PL/I source segment, 
newpath 

pathname of output PL/I source segment. 

con trol_ args 
-brief, -bf 
-comment N, -cm N 
-indent N, -in N 
-lmargin N, -lm N 



initiate, in 

enables users to initiate segments directly, i<e., not 
using the normal search rules. 

Usage: initiate path {ref_names} {- control _ arg } 

ref_ names 

reference names for the segment. 

control_arg 
-long, -lg 



io_call, io 

performs an operation on a designated I/O switch. 

Usage: io attach switchname modulename { args } 
Usage: io detach switchname 
Usage: io open switchname mode 
Usage: io close switchname 

Usage: io get_ line switchname {n} {- control_args } 
Usage: io get^chars switchname n {-control_args } 
Usage: io put_ chars switchname { string } 

{- con trol_ args} 
Usage: io read_record switchname n {-control_args} 
Usage: io write__record switchname { string } 

{-control_args} 
Usage: io rewrite _ record switchname {string} 

{-control_args} 
Usage: io delete_record switchname 
Usage: io position switchname type 
Usage: io seek_ key switchname key 
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Usage: io read_key switchname 

Usage: io read_length switchname 

Usage: io control switchname order 

Usage: io modes switchname {string } {-brief} 

Usage: io find_iocb switchname 

Usage: io look_iocb switchname 

Usage: io move_attach switchname switchname2 

Usage: io destroy_iocb switchname 

Usage: io print_iocb switchname 

switchname 

name of the I/O switch. 

module name 

name of I/O module used in attachment. 

args 

any arguments accepted by the I/O module 
used in attachment. 

mode 

stream_input, si 
stream_output, so 
stream_input_output, 
sio 

sequential_input, sqi 
sequential_output, 
sqo 

sequential, input _ out- 
put, sqio 

sequential_update, 
squ 

n 

decimal number. 

string 

any character string. 

type 

bof, - 1 set to beginning of file, 
eof, 1 set to end of file, 

f N set forward N records or lines, 

r N set back N records, 

othern number whose interpretation de- 
pends on I/O module being used. 

key 

string of ASCII characters with 
0 < length < 256. 



keyed_sequential_input, 
ksqi 

keyed_ sequential_output, 
ksqo 

keyed_sequential_up- 

date, ksqu 
direct_ input, di 
direct_ output, do 
dire ct_ update, du 
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order 

one of the orders accepted by the I/O module 
used in the attachment of the I/O switch. 

control_args 
-brief, -bf 
—lines 
-nl 
-nnl 

-segment path {offset}, -sm path {offset} 
-segment path {length}, -sm path {length} 
-segment path {offset} {length}, 
-sm path {offset} {length} 

-line_length, 11 

sets the maximum length of a line output to the de- 
vice that a process is connected to through the 
user_output I/O switch. 

Usage: line_ length maxlength 

maxlength 

maximum length of line. 

link, Ik 

creates a storage system link with a specified name in i 
specified directory pointing to a specified segment or 
directory. 

Usage: link pathl 1 path21 . . . pathln { path2n} 
pathli 

pathname of the segment to which path2i is to 
point. 

path2i 

pathname of the link to be created. 

list, Is 

prints information about entries contained in a 
single directory. 

Usage: list {entrynames} {-control_args} 

entry names 

names of entries to be listed. 

control_args 

listed below by function. 

Directory: 

-pathname path, -pn path 
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Entry Type: 
-all, -a 
—branch, -br 
—directory, -dr 
-file, -f 
-link, -lk 

-multisegment_file, -msf 
-segment, -sm 
Columns: 

—count, -ct 

-date_ time_ contents_ modified, — dtcm 
-date_time_entry__modified, -dtem 
-date_time_used, — dtu 
-length, -In 
-link_path, -lp 
—mode, — md 
-name, -nm 
-record, -rec 

Totals/Header Lines: 

-no_ header, -nhe 

-total, -tt 
Multiple-Name Entries: 

-match 

-primary, -pri 

Entry Order: 
-reverse, -rv 
-sort XX, -sr XX 

Entry Exclusion: 

-exclude entryname, -ex entryname 
-first N, -ft N 
-from DT, -fm DT 
-to DT 

Output Format: 
-brief, -bf 
-short, -sh 

list_abs_requests, lar 

prints information/about absentee requests. 

Usage: list_abs_requests {-control_args } 

-all, -a 
-long, -lg 
-queue N, -q N 
-total, -tt 



list_acl, la 

lists the ACLs of segments, multisegment files, and 
directories. 

Usage: list_acl {path} {User_ids} {-control_args} 

-brief, -bf 
-directory, -dr 
— ring_brackets, -rb 
-segment, -sm 

list _ daemon requests, ldr 

prints information about dprint and dpunch requests. 

Usage: list_daemon_requests {-control_args} 

-all, -a 
-long, -lg 
-queue N, -q N 
-request_type XX, -rqt XX 
-total, -tt 

list_iacl_dir, lid 

lists some or all of the entries on a directory initial 
ACL in a specified directory. 

Usage: list_iaci_dir {path} {User_ids} 
{-control_args} 

-brief, -bf 
-ring N, -rg N 

list_iacl_seg, lis 

lists entries on a segment initial ACL in a specified 
directory. 

Usage: list_iacl_seg {path} {User_ids} 
{-control_args} 

-brief, -bf 
-ring N, -rg N 

list_ref_names, lrn 

lists the absolute pathname and reference names 
associated with a segment. 

Usage: list_ref_names paths {-control_args} 

-all, -a 
-brief, -bf 
-from N -to N 
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list_resources, lr 

lists resources that are assigned or attached to the 
calling process by the resource control package (RCP). 

Usage: list_resources {-control_args} 

-assignments, —asm 
-attachments, -atm 
-device XX, -dv XX 
-long, -lg 
-type XX, -tp XX 



login, 1 

used to gain access to the system. 

Usage: login Person_id {Project_id} {-control_args} 

Person_id 

user's personal identifier. 

Project_id 

identification of the user's project. 

control_args 



-authorization XX, 

-auth XX 
-brief, -of 
-change_de- 

fault_auth, -cda 
-changede- 

fault_project, -cdp 
-change_pass- 

word, -cpw 
-force 

-generate _ pass- 
word, -gpw 

-home_dir path, 
-hd path 

-modes XX 



-no_preempt, -np 
— no_print_off, -npf 
-no_start_up, -ns 
-no_warning, -nw 
-outer_module p, 

-om p 
-print_off, — pf 
-process_overseer 

path, -po path 
-ring N 

-subsystem path, 

-ss path 
-terminal_type XX, 

-t tpXX 



logout 

terminates a user session. 

Usage: logout {-control_args } 

-brief, -bf 
-hold 
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mail, ml 

sends a message to another user or prints messages 
in a mailbox. 

Usage: (sending) 

ml path Person_idl Project_idl . . 
{ Person_idn} { Project_idn} 

(printing) 

ml {path} {-control_arg} 
-brief, -bf 

SENDING 

If path is *, mail responds with "Input:" and 
accepts lines from the terminal until a line consisting 
of a period (.) is typed. 

PRINTING 

If no path argument is given, the contents of the de- 
fault mailbox is printed. 

CREATING A MAILBOX 

A default mailbox is created automatically the first 
time a user types "mail"; the default mailbox is: 

>user_dir_dir>Project_id>Person_id>Person_id. 

MAP 

tells system user has terminal that generates only 
uppercase characters; system then maps each typed 
character to lowercase unless it is preceded by a 
backslash (\). 

Usage: MAP 
memo 

maintains an interactive notebook and reminder list. 

Usage: memo {-control_arg } {optional_args} 
{ memo_text } 

control_args 
-brief, -bf 
-delete, -dl 
-list, - Is 
-off 
-on 

-pathname path, -pn path 
-print, -pr 
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optional_args 
memo_ number 
-alarm, -al 
-call 

-date DT, -dt DT 
-invisible, -iv 
-match XX 
-repeat intvl, - rp intvl 
-time DT, -tm DT 
memo_text 

text of memo being set. 

move 

moves a designated segment or multisegment file (and 
its ACL and all names on the designated file) to a new 
position in the storage system hierarchy. 

Usage: move pathll { path2l}. . . pathln {pafh2n} 
{-control_arg } 

pathH 

pathname of segment to be moved. 
path2i 

pathname to which pathli is to be moved. 

control_arg 
-brief, -bf 

move_quota, mq 

moves storage quota between two directories, one 
immediately inferior to (contained in) the other. 

Usage: move_quota pathi quota_changel . . 
. pathn quota_changen 

pathi 

pathname of directory. 

quo ta_ changei 

number of records to be moved between the 
containing directory quota and the pathi quota. 

new_proc 

destroys the user's current process and creates a new 
one, using the control arguments given initially with 
the login command, and the optional control argument 
to the new_proc command itself. 

Usage: new_proc {-control_arg } 

-authorization XX, -auth XX 
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page_trace, pgt 

prints a recent history of page faults and other system 
events within the calling process. 
Usage: page_trace {count} {-control_arg } 
count 

prints the last count of system events recorded 
for the calling process. 

control_arg 
-long, -lg 



invokes the PL/I compiler. 

Usage: pll path {-control_args} 

-brief, -bf 

- brief _ table, -bftb 

-check, -ek 

-debug, -db 

-list, -Is 

-map 

-optimize, -ot 



-profile, -pf 
- severity N, -svN 
—source, — sc 
-symbols, -sb 
-table, -tb 
-time, -tm 



pll_abs, pa 

submits an absentee request to perform PL/I 
compilations. 

Usage: pll_abs paths {-pll_args} {-dp_args} 
{-abs_control_args } 

pll_abs 

control arguments accepted by the pll 
command. 

dp_args 

control arguments (except -delete) accepted 
by the dprint command. 

abs_control_args 
-queue N, -q N 
-hold 

-output_file path, - of path 

print, pr 

prints a specified ASCII segment on the user's 
terminal. 

Usage: print path { begin } { end } 



40 



begin 

the line number that identifies where printing 
begins, 
end 

the line number that identifies where printing 
ends. 

print_attach_table, pat 

prints a list of attached I/O switches, their attach 
descriptions, and opening mode. 
Usage: print_attach_table {switch. names} 

switch_ names 

names of I/O switches. 

print_auth_names, pan 

prints the names of the sensitivity levels and access 
categories defined for the installation. 
Usage: print_auth_names {-control_args} 

-aU, -a 
-brief, -bf 
-category, -cat 
-level 

print_default_wdir, pdwd 

prints out the pathname of the current default work- 
ing directory. 
Usage: print_default_wdir 

print__messages, pm 

prints any interprocess messages that were received 
(and saved in the user's mailbox) while the user was 
not accepting messages. 
Usage: print_messages 

print_motd, pmotd 

prints out changes to the message of the day since the 
last time the command was called. 
Usage: print_motd 
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print_proc_auth, ppa 

prints the access authorization of the current process 
and current system privileges (if any). 

Usage: print_proc_auth {-controI_args} 

-all, -a 
-long, -Ig 

print_request_ types, prt 

prints a list of all request types handled by the I/O 
daemon. 

Usage: print_request_ types {-control_args} 

-access_name XX, -an XX 
-brief, -bf 

-gen_type XX, -gt XX 

print_search_rules, psr 

prints the search rules currently in use. 

Usage: print_search_ rules 

print_wdir, pwd 

prints the pathname of the current working 
directory. 

Usage: print _wdir 
probe, pb 

provides symbolic, interactive debugging facilities for 
programs compiled with PL/I, FORTRAN, or COBOL. 
The program to be debugged must be compiled with 
the -table control argument. 

Usage: probe { procedure_name } 

procedure_name 

the symbolic name of the form, 
reference_name$offset_name, of an entry to a 
procedure or subroutine. 

REQUESTS 



after 


a 


Set a break after a statement. 


before 


b 


Set a break before a statement. 


call 


cl 


Call an external procedure. 


continue 


c 


Return from probe. 


execute 


e 


Execute a Multics command. 
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goto 


g 


Transfer to a statement. 


halt 


h 


Stop the program. 


if 


(none) 


Execute commands if condi- 






tion is true. 


let 


1 


Assign a value to a variable. 


mode 


(none) 


Turn brief message mode on 






or off. 


pause 


pa 


Stop a program once. 


position 


ps 


Examine a specified state- 






ment or locate a string in the 






program. 


quit 


q 


Return to command level. 


reset 


r 


Delete one or more breaks. 


source 


sc 


Display source statements. 


stack 


sk 


Trace the stack. 


status 


st 


Display information about 






breaks. 


step 


s 


Advance one statement and 






halt. 


symbol 


sb 


Display the attributes of a 






variable. 


use 


u 


Examine the block specified. 


value 


V 


Display the value of a variable, 


where 


wh 


Display the value of probe 






pointers. 


while 


wl 


Execute commands while 






condition is true. 



profile 

prints information about the execution of each state- 
ment in PL/I or FORTRAN programs. The -profile 
control argument must have been used when the 
program was compiled. 

Usage: profile paths {-control_args} 

-brief, -bf 
-long, -Ig 
-print, -pr 
-reset, -rs 

program_interrupt, pi 

allows a subsystem which establishes a handler for 
program_interrupt to regain control after a QUIT, 
fault, or call out by the use of this command. 

Usage: program_interrupt 
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progress, pg 

executes a specified command line and prints infor- 
mation about how its execution is progressing in 
terms of CPU time, real time, and page faults. 

Usage: progress {-control_arg} { command _ line} 

control_arg 
-brief, -bf 
— cput N 
-off 
—on 

-output_ switch XX, -os XX 
-realt N 

command_line 

character string created by concatenating all the 
arguments to progress (excluding the first if it 
is a control argument) with blanks between 
them. The string is executed as a command line. 

qedx, qx 

context editor used to create and edit ASCII segments 
in Multics. 
Usage: qedx {path} { optional_args } 
path 

pathname of an ASCII segment from which the 
editor takes its initial instructions. 

optionai_args 

appended, each as a separate line, to the buffer 
named args. 

REQUESTS 

Listed below in four categories giving: format, default 
in parentheses, and brief description. For value of 
ADR, see "Addressing" below; regexp, see "Regular 
Expression." 

INPUT REQUESTS 

These requests enter input mode and must be termi- 
nated with \ f. 

ADRa (.a) append lines after specified 

line. 

ADRl,ADR2c (.,.c) change existing line(s); de- 

lete and replace. 

ADR1 (.i) insert lines before speci- 

fied line. 
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BASIC EDIT REQUESTS 

ADRl,ADR2d (.,.d) delete line(s). 

ADRl,ADR2p (,,.p) print line(s). 

ADR= (.=) print line number. 

q exit from qedx editor. 

ADRr path ($r path) append contents of path 
after specified line. 

ADRl,ADR2s/regexp/string (. , .s/regexp/string/) 

substitute every regexp in 
the line(s) with string. If 
string contains &, & is re- 
placed by regexp. First 
character after s is de- 
limiter; it can be any char- 
acter not in either regexp 
or string. 

ADRl,ADR2w {path}(l,$w) 

write lines into segment 
names path; if path omit- 
ted, default pathname used. 

/regexp/ set the value of "." to the 

first line following the cur- 
rent line that contains 
regexp and print the line. 

EXTENDED EDIT REQUESTS 

e < command line> execute command line 

without leaving editor. 

ADR 1 , ADR2gX/ regexp/ ( 1 ,$gX/rege xp/) 

perform operation on lines 
that contain regexp; X 
must be d for delete, p for 
print, or = for print line 
numbers. 

ADRl,ADR2vX/regexp/(l,$vX/rege xp/) 

perform operation on lines 
that do not contain regexp; 
X must be d for delete, p 
for print, or = for print 
line numbers. 

BUFFER REQUESTS 

b(X) go to buffer names X. 

ADRl,ADR2m(x)(. , .m(X)) 

move line(s) from current 
buffer into buffer names X. 
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x give the status of all buffers 

in use. 

ADRn (.n) set the value of "." to line 

addressed. 

ADR" (.") ignore rest of line; used for 

comments. 

ADDRESSING 

Most editing requests are preceded by an address speci- 
fying the line or lines in the buffer on which the re- 
quest is to operate. Lines in the buffer can be 
addressed by absolute line number; relative line num- 
ber, i.e., relative to the "current" line; and context. 
Current line is denoted by period (.); last line of buffer, 
by dollar sign ($). 

REGULAR EXPRESSION 

The following characters have specialized meanings 
when used in a regular expression. The user can rein- 
voke the last used regular expression by giving a null 
regexp (/ /). 

* signifies any number (or none) of the preceding 
character. 

* when used as the first character of a regular expres- 
sion, signifies the character preceding the First 
character on a line. 

$ when used as the last character of a regular expres- 
sion, signifies the character following the last char- 
acter on a line. 

. matches any character on a line. 

ESCAPE SEQUENCES 

\ f exit from input mode and terminate the input 
request. 

\ c suppress the meaning of the escape sequence or 

special character following it. 
\ b(X) redirect editor stream to read subsequent input 

from buffer X. 

\ r temporarily redirects the input stream to read 
a single line from the user's terminal. 

ready, rdy 

types out an up-to-date ready message giving the time 
of day as well as the amount of CPU time and page 
faults used since the last ready message was typed. 
Usage: ready 
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ready _off, rdf 

turns off the ready message. 

Usage: ready _ off 

ready_on, rdn 

prints a ready message after each command line has 
been processed. 

Usage: ready_on 
release, rl 

releases the stack history that was automatically pre- 
served after a quit signal or unclaimed signal. 

Usage: release {-control_arg} 

-all, -a 

rename, rn 

replaces an entry name by a specified new name, with- 
out affecting any other names the entry might have. 

Usage: rename pathi namel . . . pathn namen 

pathi 

old name that is to be replaced, 
namei 

new name that replaces the entryname portion 

of pathi. 
reprint_error, re 

prints information, from the system condition handler, 
about a condition that has already been handled and 
for which stack history is preserved. 

Usage: reprint_error {-control_args} 

-all, -a 
-brief, -bf 
-depth N, -dh N 
-long, -lg 

resouree_usage, ru 

prints a report of resource consumption for current 
billing period. 

Usage: resource_usage {-control_arg } 

-brief, -bf 
-long, -lg 
-total, -tt 
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run_cobol, rc 

initiates execution of a COBOL run unit in a specified 
"main program." 

Usage: run_cobol name {-control_args} 

name 

reference name or pathname of the "main 
program" to be initiated. 

control_args 

-cobol_ switch N, -cs N 
— no_stop_run, -nsr 

runoff, rf 

types out text segments in manuscript form. 

Usage: runoff paths {-control_args} 

control_args 

-ball N, -bl N -page N, -pg N 

-character, -ch -parameter arg, 
-device N, -dv N -pm arg 

-from N, -fm N -pass N 

-hyphenate, -hph -segment, -sm 

-indent N, -in N -stop, -sp 

-no_ pagination, -to N 

-npgn -wait, -wt 
-number, -nb 

CONTROL WORDS 

Conventions to specify arguments of control requests. 

# integer constant 

c character 

cd character pair 

exp expression (either numeric or string) 

n integer expression 

± ± indicates update by n; if sign not present, set 
to n 

f segment name 

t title of the form 'partl'part2'part3' 

CONTROL REQUESTS 

If the request has a default, it is in parentheses fol- 
lowing the definition. 

•ad right justify text (on) 

-ax arabic page numbers (arabic) 

•bp begin new page 
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.br break, begin new line 

.cc c change special character from % to 

c(%) 

.cen center next n lines (1) 

.ch cd . . . . note "c" in chars segment as "d" 

.ds double space (off) 

.ef # t defines even footer line # 

.eh # t defines even header line # 

.eq n next n lines are equations (1) 

.ex text call command processor with "text" 

.fh t format of footnote demarcation line 

(underscore) 
.fi fill output lines (on) 

.fo # t equivalent to : .ef # t, .of # t 

.fr c controls footnote numbering : 

"t" reset each page, "f" continuous, 

"u" suppress numbering 
.ft delimits footnotes 

.gb xxx "go back" to label xxx 

.gf xxx "go forward" to label xxx 

.he # t equivalent to: .eh # t, .oh # t 

.if f exp segment f.runoff inserted at point of 

request; value of "exp" assigned to 

"Parameter" 
.in±n indent left margin n spaces (0) 

.la xxx define label xxx 

.lin next n lines treated as text (1) 

.11 ±n line length is n (65) 

.ma ±n equivalent to : .ml +n, .m4 ±n (4) 

.mp ±n print only every nth page (1) 

.ms +n multiple space of n lines (1) 

.ml ±n margin above headers set to n (4) 

.m2 +n margin between headers and footers 

set to n (2) 

.m3 ±n margin between text and footers set 

to n (2) 

.m4 ±n margin below footers set to n (4) 

.na do not right justify (off) 

.ne n need n lines; begin new page if not 

enough remain (1) 
.nf do not fill output lines; print them 

exactly as entered (off) 
.of # t defines odd footer line # 

.oh # t defines odd header line # 

.op next page number is odd 



49 



.pa ±n begin page n 

.pi n skip n lines if n remain; otherwise 

skip n on next page before any text 

(1) 

.pi ±n page length is n (66) 

.rd read one line of text from the 

user._ input I/O switch and process it 

in place of .rd line 
.ro roman numeral page numbers (arabic) 

.rt "return" from this input segment 

.sk n skip n lines (1) 

.sp n space n lines (1) 

.sr sym exp assign value of "exp" to variable 

named "sym" 
ss single space (on) 

.tr cd . . . . translate nonblank character c into d 

on output 

.ts n process next input line only if n is not 

zero (1) 

.ty xxx write "xxx" onto error _output I/O 

switch 

.un n indent next text line n spaces less 

(left margin) 
.ur text substitute values of variables in 

"text", and scan line again 
.wt read one line of text from user_ input 

I/O switch and discard it 
.* comment line; ignored 

.~ comment line; ignored, but included in 

chars output segment 

BUILT-IN SYMBOLS 

runoff has over 50 internal variables, which are avail- 
able to the user. In addition, the user can set his own 
variables with the .sr control request. See the runoff 
command in the MPM Commands for the list of 
built-in symbols. 

EXPRESSIONS 

Expressions can be either arithmetic or string and 
consist of numbers and operators in appropriate com- 
binations. The operators and order of precedence are: 



- (bit-wise negation), - (unary) 

*,/,\ (remainder) 

+ ,- (binary) 

=,<,>, =£, (all are comparison operators that 
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< , > yield - 1 for true or 0 for false) 

& (bit-wise AND) 

I (bit-wise OR), = (bit-wise 

equivalence) 

runoff_abs, rfa 

submits an absentee request to process text segments 
using the runoff command. 

Usage: rfa paths {-rf_args} {-ear_args} {-dp_args} 
{-abs_control_args } 

rf_args 

control arguments accepted by the runoff 
command. 

ear_args 

control arguments accepted by the 
enter_abs_request command (except -brief). 

dp_args 

control arguments (except -brief and 
-truncate) accepted by the dprint command. 

abs_control_args 
-copy N, -cp N 
-hold 

-queue N, -q N 

safety _sw_off, ssf 

turns off the safety switch of a segment, directory, or 
multisegment file, thus permitting the segment, direc- 
tory, or multisegment file to be deleted. 

Usage: safety_sw_off {paths} 



safety_sw_on, ssn 

turns on the safety switch of a segment, directory, or 
multisegment file, thus preventing deletion of that seg- 
ment, directory, or multisegment file. 

Usage: safety_sw_on {paths} 

send_message, sm 

sends messages (one or more, always sent one line at a 
time) to a given user on a given project. 

Usage: send_message Person_id Project_id {message} 
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message 

a string up to 132 characters long. If omitted, 
send_message types "Input :" and accepts 
lines that it sends, one at a time, with each new- 
line character. In this case, input is terminated 
by a line consisting solely of a period. 



set_acl, sa 

manipulates the ACLs of segments, multisegment files, 
and directories. 

Usage: sa path model User_idl . . . moden { User_idn} 
{-control_args} 

-directory, -dr 
-segment, -sm 

set_bit_count, sbc 

sets a specified bit count on a specified entry. 

Usage: set_bit_count pathl countl . . . pafhn countn 
counti 

is the bit count, in decimal, desired for pathi. 



set_cc 

sets the carriage control transformation for a specified 
FORTRAN formatted file either on or off. 

Usage: set_cc fileN {-control_arg} 

fileN 

name of the FORTRAN file in the range of 
fileOl to file99. 

control_arg 
-off 
-on 

set_com_line, scl 

changes the maximum size of expanded command 
lines. 

Usage: set_com_line {size} 
size 

is the new maximum expanded command line 
size. 



52 



set_iacl_dir, sid 

adds entries to a directory initial ACL in a specified 
directory or modifies the access mode in an existing 
directory initial ACL entry. 

Usage: sid path model User_idl . . . moden { User_idn} 
{-control_arg} 

-ringN,-rgN 

set_iacl_seg, sis 

adds entries to a segment initial ACL in a specified 
directory or modifies the access mode in an existing 
segment initial ACL entry. 

Usage: sis path model User_idl . . . moden { User_idn} 
{-control_arg} 

-ring N, -rg N 



set_search_rules, ssr 

allows the user to set his dynamic linking search rules 
to suit his individual needs with only minor restric- 
tions. Two types of search rules are permitted: abso- 
lute pathnames of directories to be searched and 
keywords. 

Usage: set_search_rules path 

set_tty, stty 

modifies the terminal type and modes associated with 
terminal I/O. 

Usage: set_tty {-control_args} 
-io_ switch XX, -is XX 
-modes XX 



can, ^can 
capo, ^apo 
crecho, ^crecho 
default" 
echoplex, 

echoplex 
edited, ^edited 
erkl, ^rkl 
esc, ^esc 
fulldpx, 

^fulldpx 



hndlquit, ^hndlquit 
lfecho, Mfecho 
UN 
plN 

rawi, ^rawi 
rawo, ^rawo 
red, ^red 
tabecho, 'Habecho 
tabs, ^tabs 
vertsp, ^vertsp 
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-print 
-reset 
-tabs 

-terminal_type XX, -itp XX 

1050 TN300,tn300 
2741 TTY33,tty33 
ARDS,ards TTY37,tty37 
ASCII, ascii TTY38, tty38 

CORR2741, corr2741 

sort_seg, ss 

orders the contents of a segment according to the 
ASCII collating sequence. 

Usage: sort_segpath {-control_args} 

-all, -a 

-ascending, -asc 
-block N, -bk N 
-delimiter XX, -dm XX 
-descending, -dsc 
-field SI L1S2L2. . .SnLn, 

-flSl LI S2 L2. . . Sn Ln 
-replace, — rp 
-segment path, -sm path 
-unique, -uq 

start, sr 

resumes execution of the user's process from the point 
of interruption after a signal has suspended execution. 

Usage: start {-control_arg} 

-no_restore, -nr 

status, st 

prints status information about storage system entries. 

Usage: status paths {-control_args} 

Segments, Multisegment Files, and Directories: 
-all, -a 
-author, -at 
-date, -dt 
-device, -dv 
-length, -In 
-mode, -md 
-name, -nm 
-type, -tp 
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Links: 

-all, -a 
-author, -at 
-date, -dt 
-name, -nm 
-type, -tp 

stop_coboI_run, scr 

causes the termination of the current COBOL run 
unit. 

Usage: stop_cobol_run {-control_arg } 
-retain_data, -retd 

terminate, tm 
terminate_segno, tms 
terminate_refname, tmr 
terminate_single_refname, tmsr 

terminates reference names for a segment, unsnaps links 
to the segment, and makes the segment unknown if it 
has no reference names left. 

Usage: terminate paths 

Usage: tms seg_nos 

Usage: tmr ref names 

Usage: tmsr ref_names 

seg_nos 

segment numbers (in octal). 

ref _ names 

reference names. 



trace 

a debugging tool that monitors all calls to a specified 
set of external procedures. 

Usage: trace {-control_args} names 

control_args 
-after N 
-argument N, 

-ag N 
-before N 
-brief, -bf 
-depth N, -dh N 
-every N, -ev N 
-execute XX, 



-meter off, -mt off 
-meter on, -mt on 
-off entryname 
-on entryname 
-out 

-remove entryname, 

-rm entryname 
-reset entryname, 
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-ex XX 
-first N, -ft N 
-govern off, 

-gv off 
-govern on, 

-gv on 
-in 
-inout 

— io_ switch XX, 
-is XX 
-last N, -It N 
-long, -lg 



-rs entryname 
-return_value off, 

-rv off 
-return_value on, -rv on 
-status *, -st * 
-status entryname, 

-st entryname 
-stop_proc path, -sp path 
-subtotal, -stt 
-template, -tp 
-total, -tt 

-watch XX, -wh XX 



names . 
is a pathname or reference name used in the 

trace table. 



trace_stack, ts 

prints machine conditions and stack history ot the 
process, most recent first. 
Usage: trace_stack {-control_args} 

-brief, -bf 
-depth N, -dh N 
-long, -lg 



truncate, tc x 

truncates a segment to a specified length and resets the 

bit count accordingly. 
Usage: truncate {-control_arg } seg_no length 
seg_no 

a pathname or an octal segment number, 
length 

an octal integer indicating the length ot the 
segment in words after truncation. 

control _arg 
-name, -nm 



unassign_resource, ur 

unassigns a resource that has been assigned to the 
caller's process. 
Usage: unassign_resource resource {-control_args} 
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resource 

specifies the name of the resource to be 
unassigned. 

control_args 

-comment XX, - com XX 
-admin, -am 

unlink, ul 

deletes the specified link entry. 

Usage: unlink paths 

vfile_adjust, vfa 

adjusts a storage system file left in an inconsistent 
state by an interrupted opening. 

Usage: vfile_adjust path {-control_arg} 

-set_bc 
-set_nl 
-use_bc {n} 
-usenl 

vfile_status, vfs 

prints the apparent type (unstructured, sequential, 
blocked, or indexed) and length of storage system 
files. 

Usage: vfile_status path 

walk_subtree, ws 

executes a command line in a given directory (called 
the starting node) and in directories inferior to the 
starting node. 

Usage: walk_subtree path command_line {-control_args} 

command_line 

command line to be executed (multiple-word 
command line should be typed as a quoted 
string). 

control_args 

-bottom_up, — bu 
-brief, -bf 
-first N, -ft N 
-last N, -It N 
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where, wh 

searches for a given reference name using the standard 
search rules and initiates the segment if found. 

Usage: where re f_ names 
who 

lists User_ids and other information about current 
users of the system. 

Usage: who {args} {-control_args } 

args 

Person_id 

.Project_id 

Person„id.Project_id 

control _ args 
-absentee, -as 
-brief, -bf 
-long, -Ig 
-name, -nm 
-project, -pj 

963 

tells system user has terminal similar to EBCDIC IBM 
Model 2741 that must be recognized before he can log 
in. 

Usage: 963 
029 

tells system user has terminal similar to Correspond- 
ence code IBM Model 2741 that must be recognized 
before he can log in. 

Usage: 029 
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ACTIVE FUNCTIONS 

The format of each active function in this document is 
based on those found in the MPM Commands. The active 
function name is shown in boldface type followed by a brief 
description of the value this active function returns. In the 
usage line, after the name and description, the following con- 
ventions apply: 

1. For simplicity, four common types of arguments ac- 
cepted by active functions have been abbreviated as 



follows: 




str 


any character string. 


tf 


character string that has the value "true" or 




"false". 


de c 


character string that represents a decimal 




number. 


dt 


character string that represents a date and 




time (see also item 5 below). 



2. If an active function accepts more than one of a 
specific argument, "_args" is added to the argument 
name (e.g., tf_args). 

3. Arguments that must be given in pairs are indicated 
with an "A" and "B" (e.g., strA strB). 

4. Optional arguments are enclosed in braces (e.g., 
{ strB }). All other arguments are required. 

5. Each dt argument must be in a form acceptable to the 
convert_date_to_binary_ subroutine described in 
the Multics Programmers' Manual Subroutines, Order 
No. AG93. If an optional dt argument is not given, 
information about the current date and time is 
returned. 

6. The term star_name means any pathname that con- 
forms to the star convention. 

The active functions listed below are grouped according 
to operation. An abbreviated description for each active 
function is given in the following pages, arranged in alpha- 
betical rather than operational order. 
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Arithmetic 
ceil 
divide 
floor 
max 
min 
minus 
mod 
plus 

quotient 

times 

trunc 

Character String 
format_line 
index 
index_set 
length 
search 
string 
substr 
verify 

Date and Time 
date 

date _ time 
day 

day _ name 
hour 

long_date 

minute 

month 

monthnarne 

time 

year 

Logical 

and 



equal 

exists 

greater 

less 

nequal 

ngreater 

nless 

not 

or 

Segment Name 

directories, dirs 

directory 

entry 

files 

get_ pathname, gpn 

home_dir 

links 

nondirectories, nondirs 
nonlinks, branches 
nonsegments, nonsegs 
path 
pd 

segments, segs 
strip 

strip __entry, spe 

suffix 

unique 

wd 

User Parameter 
havemail 
system 
user 

Question Asking 
query 
response 
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and 

true if all the tf_args = true; otherwise false. 
Usage: [ and tf_args J 

ceil 

smallest integer > dec. 
Usage: [ ceil dec ] 

date 

date abbreviation in the form "mm/dd/yy". 
Usage: [ dale { dt } ] 

date_time 

date abbreviation, a time from 0000.0 to 2359.9, a 
time zone abbreviation, and a day of the week 
abbreviation. 

Usage: [ date_time {dt} ] 
day 

one- or two-digit number of a day of the month, from 
1 to 31. 
Usage: [day { dt } ] 

day_name 

name of a day of the week. 

Usage: [ day _ name { dt } ] 

directories, dirs 

names (separated by blanks) of all directories matching 
star_name. 
Usage: [ directories star_ name ] 

directory 

directory portion of the absolute pathname of path. 
Usage: [ directory path ] 

divide 

integer part of the value of dec A / decB. 
Usage: [ divide decA decB ] 
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entry 

entryname portion of the absolute pathname of path. 
Usage: [ entry path ] 

equal 

true if strA = strB; otherwise false. 
Usage: [ equal strA strB ] 
exists 

checks for the existence of various types of items 
depending on the value of key. 

Usage: [ exists key str ] 

key 

argument 

true if it has been passed an argument str; 
otherwise false. 

branch 

true if a branch with pathname str exists; 
otherwise false. 

directory 

true if a directory with pathname str exists; 
otherwise false. 

entry 

true if an entry with pathname str exists; 
otherwise false. 

file 

true if a segment or multisegment file str 
exists; otherwise false. 

link 

true if a link with pathname str exists; other- 
wise false. 

msf 

true if a multisegment file with pathname 
str exists; otherwise false. 

non_null_link 

true if a link with pathname str exists and 
points to an existing segment, directory, or 
multisegment file; otherwise false. 

segment 

true if a nondirectory segment with pathname 
str exists; otherwise false. 
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files 

names (separated by blanks) of all segments, direc- 
tories, links, and multisegment files matching a given 
star_name. 

Usage: [ files star_name ] 
floor 

largest integer < dec. 
Usage: [ floor dec ] 

format_line, fl 

formatted character string that is constructed from a 
control string and other optional arguments. 

Usage: [ format_line control_string { args} ] 

control_ string 

is an ioa_ control string that is used to format 
the return value of the active function. 

args 

substituted in the formatted return value, 
according to the ioa_ control string. 

get_pathname, gpn 

absolute pathname of the segment that is designated 
by the reference name or segment number specified. 

Usage: [ get_pafhname {-name } arg ] 

-name 

indicates that arg (which looks like an octal seg- 
ment number) is to be interpreted as a segment 
name. 

arg 

reference name or segment number. 

greater 

true if strA > strB; otherwise false. 
Usage: [ greater strA strB ] 

have_mail 

true if there is mail in the user's current default mail- 
box or in a specified mailbox; otherwise false. 

Usage: [ have_mail {path} ] 
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home_dir 

pathname of the user's home directory (usually of the 
form >user_dir_dir> Projected >Person_id). 

Usage: [ home_dir ] 
hour 

one- to two-digit number of an hour of the day, from 
0 to 23. 
Usage: [ hour { dt } ] 

index 

character position in strA where strB begins. If strB 
does not occur in strA, 0 is returned. 

Usage: [ index strA strB ] 
index_set 

sequence of numbers from 1 through n (where n is a 
decimal integer), separated by spaces. 

Usage: [ index _ set n ] 
length 

character representation of the number of characters 
in str. 

Usage: [ length str ] 
less 

true if strA < strB; otherwise false. 
Usage: [ less strA strB ] 

links 

names (separated by blanks) of all links matching a 
given star_name. 

Usage: [ links star_name ] 
long_date 

month name, a day number, and a year in the form 
"month, day, year". 

Usage: [ long_date {dt} ] 
max 

numerical maximum of dec_args. 
Usage: [ max dec_args ] 
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min 

numerical minimum of dec_args. 
Usage: [ min dec_args ] 

minus 

result of decA - decB. 
Usage: [ minus decA decB ] 

minute 

one- or two-digit number of a minute of the hour, 
from 0 to 59. 

Usage: [ minute { dt } ] 

mod 

decA modulo decB. 
Usage: [ mod decA decB | 

month 

one- or two-digit number of a month of the year, from 
1 to 12. 

Usage: [ month {dt} j 
month_name 

name of a month of the year. 
Usage: [ month_name {dt} J 

nequal 

true if decA = decB; otherwise false. 
Usage: [ nequal dec A decB ] 

ngreater 

true if decA > decB; otherwise false. 

Usage: [ ngreater decA decB ] 
nless 

true if decA < decB; otherwise false. 
Usage: [ nless decA decB ] 
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nondirectories, nondirs 

names (separated by blanks) of all segments, links, 
and multisegment files matching a given star_name. 

Usage: [ nondirectories star_name ] 

nonlinks, branches 

names (separated by blanks) of all segments, direc- 
tories, and multisegment files matching a given 
star_name. 

Usage: [ nonlinks star_name ] 

nonsegments, nonsegs 

names (separated by blanks) of all directories, links, 
and multisegment files matching a given star_name. 

Usage: [ nonsegments star_name ] 
not 

false if str = true; true if str = false; otherwise an error 
diagnostic. 

Usage: [ not str j 
or 

true if any tf_arg = true; otherwise false. 
Usage: [ or tf._args ] 

path 

absolute pathname of path_arg (which is a pathname). 
Usage: [ path path_arg ] 

Pd 

pathname of the process directory of the process in 
which it is invoked. 

Usage: [ pd ] 
plus 

sum of dec_args. 
Usage: [ plus dec_args ] 
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query 

true if the user's answer to the question was "yes"; 
false if the user's answer was "no"; otherwise an error 
diagnostic. If the question is more than one word (arg 
contains blanks), it must be enclosed in quotes. 
Usage: { query arg ] 

quotient 

result of decA / decB. 

Usage: quotient [ decA decB ] 
response 

answer typed by the user in response to the question 
specified by arg. If arg contains blanks, it must be en- 
closed in quotes. 

Usage: [ response arg ] 

arg 

the question to be asked. 

search 

first character position in strA that meets the follow- 
ing test: does any character in strB occur in strA? If 
no character of strB occurs in strA, 0 is returned. 

Usage: [ search strA strB ] 

segments, segs 

names (separated by blanks) of all segments matching 
a given star_name. 

Usage: [ segments star_name ] 
string 

single character string. If no str_args are present, a null 
character string is returned. If one or more str_args are 
present, then any quotes in these are doubled when 
str_args are placed in the quoted return string. 

Usage: [ string {str_args} ] 
strip 

absolute pathname of the specified entry with the 
last component removed. If str is specified, the last 
component is removed only if it matches str. 

Usage: [ strip path {str} ] 
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strip _entry, spe 

entryname portion of the absolute pathname returned 
by the strip active function. If str is specified, the last 
component is removed only if it matches str. 

Usage: [ strip_entry path {str} ] 
substr 

portion of str starting with decA and continuing for 
decB characters (the default for decB is 1 ). 

Usage: [ substr str decA {decB } ] 
suffix 

last component of the entryname portion of the speci- 
fied segment. If that entryname has only one com- 
ponent, it returns the null string. 

Usage: [ suffix path ] 
system 

various installation-dependent system parameters 
Usage: [ system key ) 
key 

company 

per-system parameter company name. 
date_up 

date that the system was brought up, in the 
form "mm/dd/yy". 

department 

per-system parameter computer center de- 
partment name. 

down_until_date 

date that the system will next be brought up, 
if specified by operator, in the form 
"mm/dd/yy". 

down_until_time 

time that the system will next be brought up, 
if specified by operator, in the form 
"hhmm.t". 

ds_ company 

per-system parameter company name, with 
the characters of the name double spaced. 
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ds_department 

per-system parameter computer center de- 
partment name, with the characters of the 
name double spaced. 

installation_id 

per-system parameter installation 
identification. 

last_down_date . 

date that service was last interrupted, 
whether by shutdown or crash. 

last__down_reason 

reason for the last system service interrup- 
tion, if known. The reason may be: 
shutdown normal system shutdown 
crash system crash (no number 

assigned) 

n number of system crash 

last_down_time 

time that service was last interrupted, 
maxunits 

current maximum number of load units, in 

the form "nnn.n". 

max_ users 

current maximum number of users. 

n_units 

current number of logged-in load units in- 
cluding daemon and absentee, in the form 
"nnn.n". 

nusers 

current number of logged-in users including 
daemon and absentee. 

next_down_date 

date that system will next be shut down, if 
specified by operator. 

nextdowntime 

time that system will next be shut down, if 
specified by operator. 

next_ shift 

next shift number. 



reason_down 

reason for next shutdown, if specified by 
operator. 

shift 

current shift number. 

shift_change_date 

date on which current shift number will 
change to next_shift. 

shif t_ change_ time 

time at which current shift number will 
change to next_shift. 

sysid 

version number of the hardcore system tape 
currently running. 

time _ up 

time that system was brought up, in the 
form "hhmm.t". 

time 

four-digit time of day in the form "hh:mm" where 
00 < hh < 23 and 00 < mm < 59. 

Usage: [time{dt}] 
times 

result of decA * decB. 
Usage: [ times decA decB ] 

trunc 

largest integer whose absolute value is < absolute value 
of dec. 

Usage: [ trunc dec ] 
unique 

unique character string as generated by the 
unique_chars_ subroutine. 

Usage: [ unique ] 
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user 

various user parameters. 
Usage: [ user key ] 
key 

absentee 

true if the user is an absentee user; other- 
wise false. 

absin 

absolute pathname of absentee user's ab- 
sentee input segment including the absin 
suffix; otherwise a null string. 

absout 

absolute pathname of absentee user's ab- 
sentee output segment; otherwise a null 
string. 

anonymous 

true if the user is an anonymous user; 
otherwise false. 

auth 

short string for the authorization of the 
user's process or system_low. 

auth_long 

long string (in quotes) for the authorization 
of the user's process or "system_low". 

brief_bit 

true if the user specified the -brief control 
argument in his login line; otherwise false. 

cpu_secs 

user's CPU usage (in seconds) since login, in 
the form "sss.t" with leading zeros 
suppressed. 

log_time 

user connect time (in minutes) since login, 
the form "mmm.t". 

login_date 

date at login time, in the form 
"mm/dd/yy". 

login_time 

time of login, in the form "hhmm.t". 
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max_auth 

short string for the max authorization of the 
user's process or system_low. 

max_auth_long 

long string (in quotes) for the max authori- 
zation of the user's process or "system_low" 

name 

user's User_id at login time. 

outer_ modulo 

initial outer modulo for the terminal channel. 

preemption_time 

time at which the primary user becomes 
eligible for group preemption, in the form 
"hhmm.t". 

process_id 

user's process identification in octal. 

project 

user's Project_ id. 

protected 

true is user currently a primary user and 
protected from preemption; otherwise false. 

secondary 

true if the user is currently subject to pre- 
emption; otherwise false. 
term_id 

user's terminal ID code. It is "none" if the 
user's terminal does not have the answer- 
back feature. 

term_type 

user's terminal type. It can have one ot the 
following values: 

"Absentee" "CORR2741" "TN300" 
"Network" "TTY33" "ARDS" 
"1050" "TTY37" "ASCII" 
"2741" "TTY38" 

verify 

first character position in strA that fails the following 
test: does any character in strB occur in strA? If every 
character of strB occurs in strA, 0 is returned. 

Usage: [ verify strA strB ] 
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wd 

pathname of the working directory. 
Usage: [ wd ] 

year 

two-digit number of a year of the century. 
Usage: [ year { dt } ] 
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Unused Characters 

These characters are reserved for future use: 



SOH 


001 


ACK 


006 


DC4 


024 


EM 


031 


STX 


002 


DLE 


020 


NAK 


025 


SUB 


032 


ETX 


003 


DC1 


021 


SYN 


026 


ESC 


033 


EOT 


004 


DC2 


022 


ETB 


027 


IS 


034 


ENQ 


005 


DC 3 


023 


CAN 


030 


GS 


035 














RS 


036 














US 


037 
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